2.4 修改本地用户(支持增量修改)
Path: /api/v1/localUser/updateUser
Method: POST
接口描述:
- 对于更新接口中的非必须参数,如果不传,不会对该条数据相对应参数进行修改
请求参数
Headers
参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
Content-Type | application/json | 必须 |
Body
- 对于参数password,为了保障数据传输过程中(数据从浏览器/客户端到服务端的过程)密码数据的安全,强烈建议使用RSA算法对密码字段进行加密(将pwdModel参数设置为'rsa')。加密方式参考《使用说明文档》附录。如果您不想对密码字段进行加密(不建议),可以不传pwdModel参数或者将pwdModel参数设置为'clear'。
- 对于更新接口中的非必须参数,如果不传,不会对该条数据相对应参数进行修改
根据id更新
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
id | string | 必须 | 用户ID | id和name传一个即可 | |
groupId | string | 非必须 | 所属组ID | 可用组织架构的查询接口获取 | |
status | number | 非必须 | 启用状态:0禁用,1启用 | ||
description | string | 非必须 | 描述 | ||
pwdModel | string | 非必须 | 'clear' | 密码加密算法类型:'clear'明文,'rsa'非对称加密 | 强烈建议使用'rsa' |
password | string | 非必须 | 密码 | 如果pwdModel使用'rsa'密码模式,需要对密码进行加密 | |
phone | string | 非必须 | 手机号码 | ||
displayName | string | 非必须 | 显示名 | ||
externalId | string | 非必须 | 外部ID | ||
string | 非必须 | 电子邮件 | |||
expiredTime | string | 非必须 | 过期时间,13位长度的Unix时间戳,'0'表示永不过期 | ||
inheritGroup | number | 非必须 | 继承所属组的应用授权:0不继承,1继承 | ||
resourceIdEditWay | string | 非必须 | 'set' | 应用编辑方式,'set'重置,'append'追加,'delete'删除 | |
resourceIdList | string[] | 非必须 | 应用ID列表 | ||
resourceNameList | string[] | 非必须 | 应用名列表 | 如果没有传resourceIdList,会以resourceNameList为准 | |
resourceGroupIdEditWay | string | 非必须 | 'set' | 应用分类编辑方式,'set'重置,'append'追加,'delete'删除 | |
resourceGroupIdList | string[] | 非必须 | 应用分类ID列表 | ||
resourceGroupNameList | string[] | 非必须 | 应用分类名列表 | 如果没有传resourceGroupIdList,会以resourceGroupNameList为准 | |
roleIdEditWay | string | 非必须 | 'set' | 角色编辑方式,'set'重置,'append'追加,'delete'删除 | |
roleIdList | string[] | 非必须 | 角色ID列表 | ||
roleNameList | string[] | 非必须 | 角色名列表 | 如果没有传roleIdList,会以roleNameList为准 | |
bandIdList | string[] | 非必须 | 群组ID列表,名称与ID只需要传一个即可,都传时以ID为准 | ||
bandNameList | string[] | 非必须 | 群组名称列表,名称与ID只需要传一个即可,都传时以ID为准 | ||
bandIdEditWay | string | 非必须 | 'set' | 角色编辑方式,'set'重置,'append'追加,'delete'删除 |
根据name更新
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
name | string | 必须 | 用户名 | id和name传一个即可 | |
groupId | string | 非必须 | 所属组ID | 可用组织架构的查询接口获取 | |
status | number | 非必须 | 启用状态:0禁用,1启用 | ||
description | string | 非必须 | 描述 | ||
pwdModel | string | 非必须 | 'clear' | 密码加密算法类型:'clear'明文,'rsa'非对称加密 | 强烈建议使用'rsa' |
password | string | 非必须 | 密码 | 如果pwdModel使用'rsa'密码模式,需要对密码进行加密 | |
phone | string | 非必须 | 手机号码 | ||
string | 非必须 | 电子邮件 | |||
expiredTime | string | 非必须 | 过期时间,13位长度的Unix时间戳,'0'表示永不过期 | ||
inheritGroup | number | 非必须 | 继承所属组的应用授权:0不继承,1继承 | ||
resourceIdEditWay | string | 非必须 | 'set' | 应用编辑方式,'set'重置,'append'追加,'delete'删除 | |
resourceIdList | string[] | 非必须 | 应用ID列表 | ||
resourceNameList | string[] | 非必须 | 应用名列表 | 如果没有传resourceIdList,会以resourceNameList为准 | |
resourceGroupIdEditWay | string | 非必须 | 'set' | 应用分类编辑方式,'set'重置,'append'追加,'delete'删除 | |
resourceGroupIdList | string[] | 非必须 | 应用分类ID列表 | ||
resourceGroupNameList | string[] | 非必须 | 应用分类名列表 | 如果没有传resourceGroupIdList,会以resourceGroupNameList为准 | |
roleIdEditWay | string | 非必须 | 'set' | 角色编辑方式,'set'重置,'append'追加,'delete'删除 | |
roleIdList | string[] | 非必须 | 角色ID列表 | ||
roleNameList | string[] | 非必须 | 角色名列表 | 如果没有传roleIdList,会以roleNameList为准 | |
bandIdList | string[] | 非必须 | 群组ID列表,名称与ID只需要传一个即可,都传时以ID为准 | ||
bandNameList | string[] | 非必须 | 群组名称列表,名称与ID只需要传一个即可,都传时以ID为准 | ||
bandIdEditWay | string | 非必须 | 'set' | 群组编辑方式,'set'重置,'append'追加,'delete'删除 |
请求示例
{
"id": "23c916f0-5583-11eb-880a-913383f106f2",
"status": 1,
"description": "sdsa",
"email": "",
"phone": "",
"groupId": "1059f620-5583-11eb-880a-913383f106f2",
"expiredTime": "0",
"inheritGroup": 1,
"bandIdEditWay": "append",
"bandIdList": [ "5559f620-5583-11eb-880a-913383f106f2", "6659f620-5583-11eb-880a-913383f106f2"],
"roleIdEditWay": "append",
"roleIdList": [ "7759f620-5583-11eb-880a-913383f106f2", "6559f620-5583-11eb-880a-913383f106f2"],
}
返回数据
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | number | 必须 | 错误码,非0表示错误,具体含义请参考错误码定义 | ||
data | number | 必须 | 编辑的用户数 | ||
msg | string | 必须 | 描述信息 |
返回示例
{
"code": 0,
"data": 1,
"msg": "请求成功"
}
错误信息
错误提示 | 错误码 |
---|---|
用户状态,是否启用错误 | 7201 |
用户密码不能为空 | 7201 |
密码长度必须为6到128位 | 7201 |
该输入项目必须是手机号码格式, 如:[国际区号-]手机号,由数字组成,长度为6-20位 | 7201 |
该输入项目必须是电子邮箱格式,如:xxx@xx.com | 7201 |
用户最多关联2000个角色 | 10000000 |
保存失败,关联的角色不存在 | 77200004 |
密码不能属于常见弱密码 | 10000001 |
密码不能包含特殊关键字%s | 10000001 |
用户不存在 | 77200004 |
外部ID重复,请重新输入 | 10000000 |
密码不能包含用户名 | 10000000 |
用户名不允许被编辑 | 10000000 |
组织架构不存在 | 10000001 |
应用不存在 | 77200001 |
保存失败,关联的应用集不存在 | 77200004 |
部分角色数据已经删除,请重新选择 | 10000001 |
保存失败,关联的应用不存在或已被删除 | 77200004 |
保存失败,关联的应用分类不存在或已被删除 | 77200004 |
用户最多关联1000个应用 | 77200004 |
密码不能包含用户名 | 10000000 |